---
title: Workable
sidebarTitle: Workable
---

import Overview from "/snippets/overview.mdx"
import PreBuiltTooling from "/snippets/generated/workable/PreBuiltTooling.mdx"
import PreBuiltUseCases from "/snippets/generated/workable/PreBuiltUseCases.mdx"

<Overview />
<PreBuiltTooling />
<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account | ❓ |  |
| Paid test account | ❓ |  |
| Partnership | ❓ | |
| App review | ❓ |  |
| Security audit | ❓ | |


## Setup guide

_No setup guide yet._

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/workable.mdx)</Note>


## Useful links

Workable offers API keys ("API access token"), partner tokens, and OAuth for authentication. Nango currently only supports API-key-based authentication.

-   [API Docs](https://workable.readme.io/reference)
-   [How to generate an API key](https://workable.readme.io/reference/generate-an-access-token#generate-an-api-access-token)
-   [OAuth related docs](https://workable.readme.io/page/oauth)
-   [Workable API rate limits](https://workable.readme.io/reference/rate-limits)
-   [Web API docs (their REST API)](https://workable.readme.io/reference/accounts)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/workable.mdx)</Note>

## Connection configuration in Nango

- Workable requires a user specific subdomain for the API base URL.

## API gotchas

- To authorize a Workable Connection in Nango you need to pass both the API key and the company's workable subdomain.
- The API base URL in Nango is set to `https://{subdomain}.workable.com` for future forward compatability. To call endpoints of the V3 API, prefix the endpoint with `/spi/v3/`, e.g. `/spi/v3/candidates`.

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/workable.mdx)</Note>

<Card title="Connect to Workable" icon="link" href="/integrations/all/workable/connect" horizontal>
  Guide to connect to Workable using Nango Connect.
</Card>
